home *** CD-ROM | disk | FTP | other *** search
/ CU Amiga Super CD-ROM 18 / CU Amiga Magazine's Super CD-ROM 18 (1997)(EMAP Images)(GB)[!][issue 1998-01].iso / CUCD / Online / Henry / Tutorial < prev   
Encoding:
Text File  |  1997-11-06  |  8.8 KB  |  212 lines
  1.                              Henry - Amiga IRC Bot
  2.  
  3.                         Short tutorial for beta versions
  4.  
  5.                                       By
  6.                                  Rune Jacobsen
  7.  
  8. Contents
  9.  
  10. 1. Introduction
  11. 2. Installation
  12. 3. Configuration
  13. 4. Running
  14.  
  15. ================================================================================
  16.                                   Introduction
  17. ================================================================================
  18.  
  19. Ok, so this is not really a tutorial. But it explains stuff, so read it anyway.
  20.  
  21. ================================================================================
  22.                                   Installation
  23. ================================================================================
  24.  
  25. There is a simple installation script provided with  the  beta  distribution  of
  26. Henry.  Double  click  on  the  "Install" icon to copy the unpacked directory to
  27. somewhere. The installer script will create a "Henry"-directory in the place you
  28. choose to install it in.
  29.  
  30. If this is the first time you install Henry, copy the files General, Commands,
  31. Levels and Users from Henry/Config/Examples/ to Henry/Config/, and see the section
  32. on configuration to customize it to your liking.
  33.  
  34. ================================================================================
  35.                                  Configuration
  36. ================================================================================
  37.  
  38. One important thing to notice is that any line in any config file starting  with
  39. a  '#' is treated as a comment and skipped by Henry. Keep that in mind, and edit
  40. them files with any ASCII editor. As this is a relatively early beta  of  Henry,
  41. be warned that the config reader isn't VERY robust and mangled config files will
  42. give unexpected results.
  43.  
  44. 1. Config/General
  45.  
  46. This file contains the general options for  the  Henry  bot.  Here  is  a  quick
  47. rundown - take a look at the sample General file in Config/Examples/ to understand
  48. what the fields are referring to:
  49.  
  50.    Servers
  51.       This is a list of servers to try to connect to, in order, with an optional
  52.       port number afterwards. If no port number is set, Henry will use the
  53.       default IRC port 6667.
  54.    Nicks
  55.       This is the list of nicknames the bot will try, in order.
  56.    UserName
  57.       The user name Henry sends to the server. Should normally be the user name
  58.       you have with your ISP (the part before the '@' in your email address).
  59.    RealName
  60.       The text that will be shown to users when they do a /whois on the bot.
  61.    FindServer
  62.       The ADT server to connect to for searching Aminet. find.germany.aminet.org
  63.       is a nice default one, as is ftp.wustl.edu when it is up.
  64.    Channel
  65.       The IRC channel the bot should join.
  66.    Signoff
  67.       The quit message the bot signs off with.
  68.    CommandChar
  69.       If the first character in a public message is this character, the rest
  70.       of the line will be taken to be a command to the bot.
  71.    PublicLogLineLength
  72.       The max. length of a line in the log.
  73.    Debug
  74.       If set to On, will save lots of debug info in Logs/Debug.log.
  75.    ShowPublic
  76.       Will send all public messages to STDOUT.
  77.    PublicLog
  78.       Will log all public message to Logs/YYMMDD_#Channel.log
  79.    PublicLogon
  80.       Will show the logon procedure in the public log. No real effect yet.
  81.  
  82. 2. Config/Users
  83.  
  84. This file is Henry's user database. There is no other limit  to  the  amount  of
  85. users than the amount of memory availible. The fields in this file represent:
  86.  
  87.    Entry
  88.       The entry name. Should normally be the same as the persons nickname. This
  89.       is used if you do a SEEN (to see when the user was still on) or a ADDMSG (to
  90.       send a message to someone).
  91.    Access
  92.       This users access level on the bot. Is used to determine what commands the
  93.       user can execute and stuff. Can be from 0 to 255.
  94.    File
  95.       File access. Not yet used.
  96.    Seen
  97.       This is the last time the user was seen online by the bot. The number should
  98.       not really be edited manually.
  99.    News
  100.       The last time this user read news on the bot. This is used to determine
  101.       wether or not there are new ones for him/her to read.
  102.    Greet
  103.       The autogreet this user will recieve when joining the channel. If you don't
  104.       put anything here, the bot won't say a thing.
  105.    Mask
  106.       The host mask the user will be on. '*' is acceptable as a wildcard. For
  107.       instance, as my username at work is rune and I would log on from one of
  108.       Euroline's (my job) machines, a good host mask would be
  109.       *!*rune@*euroline.no - This would match any nickname I would use, wether
  110.       or not I am authenticated with identd, and would work on any computer
  111.       in the euroline.no network. You can have as many mask lines as you want,
  112.       useful for people with several accounts etc.
  113.  
  114. 3. Config/Levels
  115.  
  116. Really simple file, this. Just some default levels.
  117.  
  118.    AutoOp
  119.       The access level someone needs to be automatically given channel operator
  120.       status when they join. This will of course only happen if the bot is a
  121.       chanop himself.
  122.    DefaultLevel
  123.       The default level someone has when their host mask does not match anything
  124.       found in the user database.
  125.    DefaultFileLevel
  126.       Same as above, but for file access. No effect yet.
  127.    AutoRoulette
  128.       This has no effect yet, but those interested can guess what it is for.
  129.  
  130. 4. Config/Commands
  131.  
  132. This defines the commands your bot users will be able  to  perform.  This  means
  133. that  every  command in your bot is totally configurable, nothing is preset, and
  134. everything has a reasonably cool level of custimization.
  135.  
  136. The attributes a command can have:
  137.  
  138.    Command
  139.       This is the command name, what the users will have to type to execute the
  140.       command.
  141.    CommandString
  142.       This depends on the type of command. For internal commands, this is the
  143.       name of it. For ARexx scripts, this is the path/filename of the script. To
  144.       see what internal commands are availible, you have to check out the sample
  145.       Config/Examples/Commands file - it has them all in there somewhere.
  146.    InfoString
  147.       When someone requests help on a command (using the INFO internal command),
  148.       this is the description message they get.
  149.    SyntaxString
  150.       The syntax of the command, displayed by the INFO internal command.
  151.    Type
  152.       1 for internal command, 2 for ARexx command. Other command types are
  153.       currently not supported.
  154.    Access
  155.       The access level someone needs to execute this command. For instance,
  156.       the internal QUIT command should only be availible to people with
  157.       sufficient access to shut down the bot.
  158.    PublicAccess
  159.       Some Henry commands return results, and if this is the case, this is
  160.       used to determine if the result of the command should be public. If a
  161.       user has a HIGHER level than PublicAccess for this command, the result
  162.       will be displayed in public.
  163.    LogIllegal
  164.       TRUE or FALSE - should illegal attempts to execute this command be logged
  165.       in Logs/System.log ?
  166.    DataBaseName
  167.       Some commands are used for displaying, deleting or adding database items.
  168.       Since Henry supports unlimited number of databases, this field tells him
  169.       which of the databases this is related to. For instance, in the sample
  170.       Config/Examples/Commands file, both the "URL" and the "FAQ" commands
  171.       use the internal FINDDBITEM command, but they point to different
  172.       databases. The databases are defined in the Config/Databases file,
  173.       explained later in this section.
  174.  
  175. 5. Config/Messages
  176.  
  177. This file just keeps the messages for the different  users.  It  should  not  be
  178. edited  manually,  and  probably  not  read  by evil bot operators ;). Should be
  179. encrypted or something in the future.
  180.  
  181. 6. Config/Databases
  182.  
  183. Again, a very simple file,  with  a  very  simple  format.  On  each  line,  one
  184. database, a colon, a space, and the name of the database file. For instance:
  185. FAQ: FAQ.hdb
  186. Would mean a database called FAQ is located in FAQ.hdb. You  can  have  as  many
  187. databases as you want.
  188.  
  189. The format of the database files (*.hdb) is also simple. One item on  one  line,
  190. in this format:
  191. Name: Item text.
  192. The item text can be as long as you  want.  For  instance,  an  item  in  a  FAQ
  193. database could be like this:
  194. Henry: Amiga IRC Bot by Rune 'Shitlips' Jacobsen
  195. This item would then be displayed when someone gave the command "FAQ  Henry"  to
  196. the  bot,  provided that FAQ is the internal command FINDDBITEM, pointing to the
  197. FAQ database.
  198.  
  199. 7. Config/NewsDB
  200.  
  201. Another file you shouldn't mess with manually. It keeps all the  unexpired  news
  202. items.
  203.  
  204. ================================================================================
  205.                                     Running
  206. ================================================================================
  207.  
  208. Start Henry from a shell or the Workbench. After a little bit it  should  either
  209. pop  up  on  the  IRC  channel  you've configured, or complain that something is
  210. wrong.
  211.  
  212.